package com.xuecheng.learning.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.xuecheng.api.learning.model.dto.CourseRecordDTO;
import com.xuecheng.api.media.model.ResourceUrlModel;
import com.xuecheng.common.domain.page.PageRequestParams;
import com.xuecheng.common.domain.page.PageVO;
import com.xuecheng.learning.entity.CourseRecord;

/**
 * <p>
 * 选课记录 服务类
 * </p>
 *
 * @author itcast
 * @since 2021-04-15
 */
public interface CourseRecordService extends IService<CourseRecord> {


    /**
     * <p>
     * 查询用户学习的课程信息
     * </p>
     *
     * @param coursePubId 课程发布id
     * @return CourseRecordDTO
     */
    CourseRecordDTO getCourseRecordByCoursePubId(Long coursePubId, String username);

    /**
     * <p>
     * 分页查询用户的课程学习记录
     * </p>
     *
     * @param params   分页参数
     * @param username 用户名
     * @return List<CourseRecordDTO>
     */
    PageVO<CourseRecordDTO> queryCourseRecordList(PageRequestParams params, String username);

    /**
     * <p>
     * 修改或创建用户的课程学习记录
     * </p>
     *
     * @param courseRecordDTO 学习记录封装对象
     * @return CourseRecordDTO
     */
    CourseRecordDTO createCourseRecord(CourseRecordDTO courseRecordDTO);

    /**
     * <p>
     * 获取视频播放资源
     * </p>
     *
     * @param coursePubId 课程id
     * @param teachplanId 课程计划id
     * @param mediaId     视频id
     * @param username    选课人用户名
     * @return ResourceUrlModel
     */
    ResourceUrlModel getResourceUrl(Long coursePubId, Long teachplanId, Long mediaId, String username);

    /**
     * <p>
     * 更新课程计划
     * </p>
     *
     * @param courseRecordDTO 课程记录数据封装
     * @return CourseRecordDTO
     */
    CourseRecordDTO updateCourseRecord(CourseRecordDTO courseRecordDTO);
}
